home *** CD-ROM | disk | FTP | other *** search
/ Computer Music 2004 January / Computer Music Magazine 68 2004.iso / pc / Software / PC Software / Full Software / Free Effects PC / Smartelectronix - Bram / MadShifta PC / readme.txt < prev   
Encoding:
Text File  |  2002-06-03  |  3.7 KB  |  95 lines
  1. Hello and welcome to Tobybear MadShifta!
  2.  
  3. This is a VST plugin (PC only) by Tobybear (www.tobybear.de) and 
  4. Bram (www.smartelectronix.com) with full Delphi source included!
  5. It is available on Bram's truly excellent DSP source code page 
  6. www.musicdsp.org!
  7.  
  8. 1. What does it do?
  9. Well, as Bram puts it: it is a "ultrafast and lofi pitchshifter",
  10. where the pitch of the audio is changed in realtime while the
  11. tempo is preserved.
  12. You can adjust the pitch in semitones (+/- 24 semitones) and
  13. with finetuning. Furthermore a delay line with feedback is
  14. included and the obligatory LP/HP filter with resonance!
  15. Extra special feature: you can use MIDI note messages to pitch
  16. the audio in realtime up or down, relatively to a root key.
  17. Furthermore a randomizer, dry/wet and output adjustments enhance
  18. the fun :-)
  19.  
  20. Note: Our main intention here was to make clear how such an algorithm
  21. could be implemented, but the way it is presented here may not
  22. necessarily be the most performance-oriented way, so there is always
  23. room for improvement.
  24.  
  25. 2. The controls:
  26. tune: pitch audio stream up/or down with up to 24 semitones
  27. fine: fine tuning of the pitching
  28. root: root note, if MIDI "Note on" messages are received the
  29. audio is pitched relatively to that note in semitones
  30. hold/back: describes MIDI behaviour: "hold" means the relative
  31. distance between root and current note stays the current pitch,
  32. if "back" is set, it falls back to the original pitch once a "note off"
  33. is received
  34. delay: delay amount, logarithmic scale
  35. feedback: feedback amount of the delay
  36. cutoff: filter cutoff
  37. resonance: filter resonance
  38. LP/HP: sets filter type (lowpass or highpass)
  39. dry/wet: controls amount of processed (pitched) signal in relation
  40. to the original signal
  41. outvol: the output volume
  42.  
  43. Click on "VS" to switch text display on/off
  44. Click on the bear to the left to randomize all parameters
  45. Click on the note to the right to randomize only pitch
  46.  
  47. 3. Why is the source code in Delphi?
  48. Well, Delphi is still a very underestimated and underrated DSP langauge,
  49. but it is in my opinion equally powerful as C++. Check out my other plugins
  50. at www.tobybear.de, they are all coded in Delphi too.
  51. So, first of all, to show people that it is also possible to compile
  52. VST plugins without a C++ compiler, secondly because there aren't that 
  53. much Delphi open source DSP codes floating around.
  54.  
  55. 4. What can I do with the source code?
  56. Look through it, learn from it, enhance it, add new features, but always
  57. give proper credits to both of us! I say it again: this plugin and its
  58. source code are mainly meant as a learning resource!
  59. Some possible extensions:
  60. - stereo mode/delay
  61. - variable buffer sizes
  62. - other filter modes
  63. - sync to host
  64. - filter/delay routing
  65. - longer delay times
  66. - LFOs
  67.  
  68. 5. What do I need to compile this plugin?
  69. A Delphi version, naturally :-), 3.0 or above should work. I coded it 
  70. with the Delphi 6 PE Edition that is available for free at 
  71. www.borland.com (150MB though!). This is the whole compiler/editor/IDE 
  72. with no restrictions, but just for personal use, you are not allowed to 
  73. sell any programs created with it.
  74.  
  75. Furthermore you need to install the tobygauges.pas component also 
  76. included with this package before attempting to compile the MadShifta 
  77. project. Just use "Component - Install Component", enter path to 
  78. tobygauges.pas in "Unit file name", then "OK". This component adds 
  79. mouseover and mousedown events to the standard Delphi gauge as well as 
  80. eliminating the need for the trunc() function.
  81.  
  82. 6. Final words
  83. None of us is responsible if anything goes wrong with this plugin, you 
  84. use it at your own risk. Of course we tried to prevent any possible harm, 
  85. after all it is just a simple pitchshifter :-)
  86.  
  87. Contact:
  88. tobybear@web.de
  89. bram@smartelectronix.com
  90.  
  91. www.tobybear.de
  92. www.smartelectronix.com
  93. www.musicdsp.org
  94.  
  95.